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(57) Abstract: The invention relates to a method 
for the creation of a documentary chain and the 
updating thereof based on a structured model. 
According to one characteristic, the method is 
based on a structured model from which relevant 
fragments are extracted, the final document is 
architectured in a word processing format using 
necessary fragments from said group of fragments 
and by ordering them as desired. As a result, it 
is possible to establish a dynamic link for each 
fragment, which is inserted and then inserted, 
between the location thereof in the documentation 
and the physical file resulting from the automatic 
generation thereof. 

(57) Abrege : La presente invention est 
relative a un procede de realisation d'une chaine 
documentaire et de sa mise a jour a partir d'un 
modele structure, et selon une caracteristique, 
on part d'un modele structure dont on extrait des 
fragments pertinents, on architecture ensuite le 
document final en format traitement de texte en 
prelevant parmi ces fragments ceux necessaires et 
en les rangeant comme desire, et on etablit ainsi 
pour chacun des fragments generes puis inseres 
un lien dynamique entre son emplacement dans 
la documentation et son fichier physique issu de 
la generation automatique. 
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PROCEDE DE REALISATION D'UNE CHAINE DOCUMENTAERE ET DE 
SA MISE A JOUR A PARTIR D'UN MODELE STRUCTURE 

La presente invention se rapporte a un procede de realisation d'une chaine 
documentaire et de sa mise a jour a partir d'un modele structure. 

II existe de nombreux generateurs automatiques de documentations a partir 
d'un modele structure, mais ils sont trop rigides du point de vue de l'organisation du 
document qu'ils creent, et ils ne permettent pas de realiser une mise a jour 
automatique du document suite a des modifications du modele. Une telle 
automatization pourrait simplifier enormement la tache de l'operateur qui en est 
charge et lui faire gagner beaucoup de temps, car la mise a jour manuelle d'une 
documentation generee a partir d'un modele structure peut etre tres longue et 
fastidieuse, en particulier lorsque ce modele est complexe et volumineux. 

La presente invention a pour objet un procede de realisation d'une chaine 
documentaire a partir d'un modele structure, permettant d' organiser le document 
qu'il produit de n'importe quelle fegon, et permettant de realiser sa mise a jour 
automatiquement. 

Le procede conforme a l'invention est caracterise en ce qu'il comporte les 
etapes suivantes : on part d'un modele structure dont on extrait des fragments 
documentaires pertinents, on architecture ensuite le document final en format 
traitement de texte en prelevant parmi ces fragments ceux necessaires et en les 
rangeant comme desire. On etablit ainsi pour chacun des fragments gen^res puis 
inseres un lien dynamique entre son emplacement dans la documentation et son 
fichier physique issu de la generation automatique. 

Selon une caracteristique de l'invention, on peut utiliser similairement 
l'outil « RHAPSODY-DOC » avec « DOORS » pour la generation des fragments 
documentaires traitant de Fmformation autour des exigences, puis la combinaison de 
« RHAPSODY-DOC » avec un traitement de textes pour inserer ces fragments 
DOORS et architecturer son document final. 

Dans la suite du document on appellera, pour plus de commodite, « fragments 
documentaires exigence » les fragments documentaires issus de DOORS et 
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« fragments documentaire s du modele » les fragments documentaires issus du 
modele structure. Par « fragment documentaire », de maniere generate, on entendra 
fragment des deux types melanges. 

La presente invention sera mieux comprise a la lecture de la description 
detaillee d'un mode de mise en oeuvre, pris a titre d'exemple non limitatif et illustre 
par le dessin annexe, sur lequel : 

- la figure 1 est une interface graphique d'une macro d'un traitement 
de textes montrant Farborescence des fragments documentaires apres 
la phase de generation des fragments du procede de Finvention., 

- la figure 2 est une vue de F interface de la figure 1 montrant la 
fonctionnalite de filtre des fragments documentaires facilitantla 
recherche de fragments, 

- la figure 3 est une vue d'une interface graphique de l'outil 
« DOORS » dans laquelle sont definies les informations d' exigences 
que Fon veut transferer dans la documentation, selon une variante du 
procede de Finvention, 

- 1 es figure s 4 , 5 et 6 sont des vue s successives d'une interface 
graphique d'un traitement de textes « WORD » dans lequel on definit 
le. icanevas du fragment documentaire, a savoir la disposition des 
informations d' exigences DOORS, telle qu'on veut la voir repartie 
dans les fragments documentaires exigences, apres generation 
documentaire, conformement au procede de Finvention, 

- la figure 7 est une vue d'un des fragments documentaires exigence 
issu de la generation documentaire et prenant en compte le canevas 
defini figures 4, 5 et 6 et les donnees exigences DOORS de la figure 3 
,et 

- la figure 8 est une vue d'une interface graphique de l'outil 
« DOORS » mise en ceuvre par le procede de Finvention pour lancer 
la generation de fragments documentaires exigences depuis DOORS. 
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Le procede de Finvention permet de generer facilement une documentation, 
par exemple au format WORD ou RTF, a partir de fragments documentaires 
provenant d'un modele UML (informations d' architecture du logiciel) et, de fa?on 
optionnelle, d'un module « DOORS » (information de tra$abilite des exigences) qui 
est un outil de gestion d'exigences de la societe TELELOGIC. 

La documentation finale obtenue comprend des parties issues de la generation 
automatique, mais aussi des parties textuelles (texte libre manuel) incluses entre les 
fragments generes. Une macro WORD permet de lancer une interface graphique qui 
organise tons les fragments documentaires generes et permet de selectionner Tun 
d'eux, puis de l'inclure tres facilement dans un document au format WORD (voir 
figure 1). 

Dans le detail, le procede de Finvention se deroule de la ia^on suivante : 

1) L'utilisateur se sert d'un outil de modelisation tel que «RHAPSODY» de la 
societe I-LOGIX. II charge sous RHAPSODY le moddle duquel il desire tirer une 
documentation (dans P exemple decrit ci-dessous, ce modele s'appelle tout 
simplement « modele »). II lance « RHAPSODY-DOC » a travers le menu 
« TOOLS » de RHAPSODY. II genere a l'aide de RHAPSODY-DOC, de fa$on 
connue en soi, les fragments documentaires du modele qu'il desire inclure dans la 
documentation finale. , v 

2) (Etape optionnelle - voir descriptif detaille de la variante de procede ci-dessous) 
L'utilisateur se sert d'un outil de gestion des exigences tel que «DOORS» de la 
societe TELELOGIC. II charge sous DOORS le module duquel il desire tirer de 
Finformation pour la documentation finale (dans F exemple decrit ci-dessous, ce 
module s'appelle tout simplement « module »). II lance « RHAPSODY-DOC » a 
travers le menu « DOORS Customs » de DOORS. II genere a Faide de 
RHAPSODY-DOC, de fagon connue en soi, les fragments documentaires des 
exigences qu'il desire inclure dans la documentation finale. 

3) Puis, il ouvre un document vide (ou un document type de son r&ferentiel de 
documentation) d'un traitement de textes, qui est « WORD » dans le cas present. 

4) L'utilisateur clique sur le bouton « Inserer un fragment » de la barre d f outils 
WORD relative a RHAPSODY-DOC pour lancer la macro WORD qui ouvre une 
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fenetre « Insert documentation fragment ». L'utilisateur selectionne dans cette 
interface le modele dans lequel se trouve son information documentaire dans la bofte 
a options « Modele ». Comme precise ci-dessus, ce modele s'appelle « modele ». II 
selectionne ensuite son generateur de fragments documentaires dans la boite a 
options « Documentation Projet». Dans Pexemple decrit ici, il s'agit de 
RHAPSODY-DOC. Apparait alors une arborescence contenant tous les fragments 
documentaires generes prealablement (voir figure 1). 

5) Puis, il selectionne un fragment dans Parbre dont la structure arborescente reprend 
Parchitecture des paquetages du modele UML de depart. II lui reste a positionner le 
curseur dans le document WORD a Pendroit ou le fragment doit etre insere, puis a 
cliquer sur le bouton «Inserer», qui se trouve dans le bandeau inferieur de 
Pinterface. 

Le nombre de fragments documentaires peut devenir tres important Pour 
faciliter la recherche du fragment a inserer, Putilisateur a la possibility de filtrer les 
fragments proposes dans la boite a options « Fragments » de Pinterface graphique, 
comme represents en figure 2. Ce filtrage se fait a partir du type de fragments 
generes. Dans Pexemple de la figure 2, le nom des types de fragments «Nom et 
description » est mis en inversion video par le passage du curseur sur leur nom, et il 
suffit alors de cliquer sur ce nom pour realiser le filtrage desire. L'arborescence 
affichee ne contient alors plus que les fragments du type desire, limi tant done de 
beaucoup leur nombre et accelerant la recherche et la selection du fragment souhaite. 

Pour effectuer la mise a jour d'un document existant, Tutilisateur, apres avoir 
fait des modifications dans son modele UML, lance le programme de generation 
documentaire depuis RHAPSODY et , de fa$on optionnelle, de DOORS pour 
remettre a jour sa base de fragments documentaires. Ensuite, il utilise la fonction 
"Mise a jour" de la macro WORD. Tous les fragments precedemment inseres seront 
automatiquement mis a jour et au bon endroit dans le document final On remarquera 
que si de nouveaux fragments sont necessaires, ils devront etre inseres 
manuellement. 

Selon une variante du procede de P invention, il est possible de recuperer de 
Pinformation issue de Poutil « DOORS » precite. II est genere pour chaque exigence 
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(Tun module DOORS un fragment documentaire exigence que Ton peut ensuite 
inserer a Fendroit desire dans le document final. 

La generation de fragments documentaires s'effectue a partir d'une vue 
DOORS d'un module ou Ton definit F ensemble des informations que Ton souhaite 
faire apparaitre dans le document WORD. L'utilisateur definit la maniere dont il 
souhaite representer ces informations dans WORD a Taide de « canevas » WORD 
(des fichiers « .dot » de modeles de presentation) et de signets WORD. Dans ce 
template, on construit la representation generique que Ton souhaite donner aux 
objets contenus dans la vue associee. Une vue DOORS est composee de colonnes, 
chaque colonne ayant un titre. Le « mapping » (la liaison) entre une vue DOORS 
(interface graphique de Foutil DOORS) et le canevas WORD associe est effectue au 
travers de signets, chaque signet portant le nom de la colonne qu'il represente. 

On a represente en figure 3 une vue DOORS. Sur cette vue, il y a quatre 
colonnes, respectivement intitulees « PUID » (identite des objets ) , « Nom » (noms 
des objets), « Statut » (etat des objets), et « Risque Impact » (impact sur les 
differents elements du modele considere ). Les objets UML apparaissant sur la vue 
et sur lesquels sont posees des exigences sont respectivement references OBJ1 a 
OBJ4. L'etat des trois premiers est « Accepte », alors que celui du dernier est « En 
negociation » (en cours de traitement). l eurs impacts respectifs sont : 
« Performance », « Utilisation operationnelle », « Organisation » et « Technologie ». 

L'utilisateur ouvre un fichier WORD et renregistre sous un nom quelconque 
avec Pextension « .dot », par exemple « Mon canevas.dot », comme represente en 
figure 4. Puis, il definit dans ce fichier Faspect general qu'il souhaite donner aux 
objets contenus dans la vue DOORS (un tableau a deux lignes et deux colonnes, 
comme represente en figure 4). Ensuite, il insere dans le document WORD un 
signet specifique pour chaque attribut DOORS qu'il souhaite extraire. II insere ce 
signet a l'endroit oix il desire voir apparaitre le contenu de l'attribut considere pour 
chacune des exigences DOORS (par exemple F exigence [111] s'appliquant sur un 
objet UML, qui est alors OBJ1) 

On a represente en figures 5 a 7 un exemple d'insertion de la colonne 
« Risque Impact » pour F objet OBJ2. En figure 5, on a represente comment 
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Putilisateur designe le point d'insertion d'un signet. En figure 6, Futilisateur choisit 
le norn du signet (« Risque impact » dans le cas present) dans la fenStre deroulante 
d'insertion de signets de WORD. En procedant de la meme maniere pour les autres 
colonnes de la vue DOORS, Futilisateur obtient un canevas « Mon canevas.dot » 
qui, apres generation a partir de DOORS, donne quatre fragments documentaires (un 
par exigence) contenant les informations specifiees (celui genere pour Fexigence 
[222] appliquee sur l'objet UML OBJ2, est represents en figure 7). 

La generation de fragments documentaires via « RHAPSODY-DOC 
GENERATION» ne fonctionne que dans le contexte ou des exigences identifies 
dans un modele Rhapsody ont ete importees sous DOORS en utilisant la fonction 
d'import de « DOORS Custom ». Dans ce cas, le module d' exigence cree suite a cet 
import est correctement implements pour la generation documentaire. A partir de ce 
module, « RHAPSODY-DOC » peut etre declenche depuis le menu « DOORS 
Custom » de DOORS. L' interface representee en figure 8 est alors lancee. 

Le champ "RHAPSODY-DOC fragmentjist Path" permet de specifier le 
chemin du fichier utilise par RHAPSODY-DOC pour lister les fragments 
documentaires generes depuis RHAPSODY ou DOORS. En general, ce fichier se 
trouve sous le repertoire « generated » du repertoire d'installation de RHAPSODY- 
DOC. 

Le champ « Dossier Destination de Generation » permet de specifier le 
chemin du repertoire ou seront generes les fragments documentaires. Si le chemin 
specifie n'a pas encore ete cree, il le sera lors de Fexport. Le champ "Generation 
Canevas" permet de specifier le template WORD (du style du fichier « Mon 
canevas.dot ») a utiliser pour la generation des fragments documentaires. Le champ 
"Options de generation" propose deux types de generation possibles : 

La premiere, « Un Fragment pax Exigence » (representee sur la figure 8), 
permet de gen6rer un fragment documentaire par exigence, 

La seconde, « Un Fragment par Container UML » (non representee sur la 
figure 8), permet de g6n6rer un fragment pax Element UML contenant des exigences 
dans le modele. Chaque fragment genere contient la liste des exigences contenues 
dans ces elements UML. 
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Une fois la generation terminee, il suffit de retoumer sous WORD et d'utiliser la 
macro WORD de RHAPSODY-DOC. Les fragments correspondant au modele UML 
concerne venant de DOORS sont classes dans la categorie « Projet Documentation » 
de RHAPSODY et DOORS. Cette categorie ne contient que les fragments 
documentaires exigences, mais Farborescence dans laquelle elles sont placees est la 
meme que celle qui se trouve dans le modele UML. 
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REVENDICATIONS 

1. Procede de realisation d'une chaine documentaire a partir d'un modele 
structure , caracterise en ce qu'il comporte les etapes suivantes : 

chargement d'un modele structure dans un outil de modelisation ; 
generation de fragments documentaires du modele ; 
selection du modele comportant rinformation documentaire et du 
generateur de fragments documentaires ; 

insertion des fragments documentaires genSres dans la structure 
documentaire de la chaine documentaire. 

2. Procede selon la revendication 1, caracterise en ce que le modele 
structure est un modele UML. 

3. Procede selon la revendication 1 ou 2 3 caracterise en ce que Fon 
effectue la mise a jour de la documentation & Faide de lien dynamiques etablis pour 
chaque fragment genere entre son emplacement dans la chaine documentaire et son 
fichier physique issu de la generation documentaire automatique. 

4. Procede selon Tune des revendications precedentes, caracterise en 
ce que le module est realise a Faide de Foutil « RHAPSODY » et que Fon utilise 
« RHAPSODY -DOC » pour generer les fragments documentaires que Fon desire 
inclure dans la documentation finale. 

5. Procede selon la revendication 4, caracterise en ce que les 
fragments documentaires generes sont inseres dans un document ouvert dans un 
traitement de textes. 

6. Procede selon la revendication 1, 2 ou 3, caracterise en ce que Fon 
utilise Foutil « RHAPSODY-DOC » avec « DOORS » pour la generation des 
fragments documentaires traitant de Information autour des exigences, puis la 
combinaison de « RHAPSODY-DOC » avec un traitement de textes pour inserer ces 
fragments DOORS et architecturer son document final. 

7. ProcedS selon la revendication 1, 2 ou 3, caracterise en ce que Fon 
utilise Foutil « RHAPSODY-DOC » avec « DOORS » et un traitement de textes 
pour la generation documentaire. 
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8- Procede selon l'une des revendications precedentes, caracterise par 
le fait que la documentation finale comporte du texte libre manuel inclus entre les 
fragments generes. 

9. Procede selon Pune des revendications precedentes, caracterise par 
le fait que l'on filtre les types de fragments generes avant leur insertion dans la 
chaine documentaire. 
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